std::basic_istream::readsome

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++0x feature) Atomic operations library (C++0x feature) Thread support library (C++0x feature)
Input/output library
basic_streambuf basic_filebuf basic_stringbuf ios_base basic_ios basic_istream basic_ostream basic_iostream basic_ifstream basic_ofstream basic_fstream basic_istringstream basic_ostringstream basic_stringstream C-style I/O
std::basic_istream
Member functions basic_istream::basic_istream basic_istream::~basic_istream Formatted input basic_istream::operator>> Unformatted input basic_istream::get basic_istream::peek basic_istream::unget basic_istream::putback basic_istream::getline basic_istream::ignore basic_istream::read basic_istream::readsome basic_istream::gcount Positioning basic_istream::tellg basic_istream::seekg Miscellaneous basic_istream::sync Member classes basic_istream::sentry

​basic_istream& readsome( char_type* s, streamsize count );​

Extracts immediately available characters from the input stream.

If ​good() != true​, ​setstate(failbit)​ is called and the function returns. At most count characters are extracted. If end-of-file is encountered earlier, ​setstate(eofbit​ is called and the function returns.

Function uses ​rdbuf()->in_avail()​ to determine how many characters are available for extraction. Note, that using this function with standard input does not guarantee that the function will not block.

Contents 1 Parameters 2 Return value 3 Example 4 See also

Parameters

s	-	pointer to the character string to store the characters to
count	-	maximum number of characters to read

Return value

​*this​

Example

This section is incomplete

See also

read	extracts blocks of characters (public member function)